package com.xy.webadmin.app.dao;

import com.xy.common.core.annotation.EnableDataPerm;
import com.xy.common.core.base.dao.BaseDaoMapper;
import com.xy.webadmin.app.model.Student;
import com.xy.webadmin.app.model.StudentClazz;
import com.xy.webadmin.app.model.StudentGuardian;
import org.apache.ibatis.annotations.Param;

import java.util.*;

/**
 * 学生数据操作访问接口。
 *
 * @author xiaoyue
 * @date 2025-05-13
 */
@EnableDataPerm
public interface StudentMapper extends BaseDaoMapper<Student> {

    /**
     * 批量插入对象列表。
     *
     * @param studentList 新增对象列表。
     */
    void insertList(List<Student> studentList);

    /**
     * 获取过滤后的对象列表。
     *
     * @param studentFilter 主表过滤对象。
     * @param orderBy 排序字符串，order by从句的参数。
     * @return 对象列表。
     */
    List<Student> getStudentList(
            @Param("studentFilter") Student studentFilter, @Param("orderBy") String orderBy);

    /**
     * 根据关联主表Id，获取关联从表数据列表。
     *
     * @param clazzId 关联主表Id。
     * @param studentFilter 从表过滤对象。
     * @param studentClazzFilter 多对多关联表过滤对象。
     * @param orderBy 排序字符串，order by从句的参数。
     * @return 从表数据列表。
     */
    List<Student> getStudentListByClazzId(
            @Param("clazzId") Long clazzId,
            @Param("studentFilter") Student studentFilter,
            @Param("studentClazzFilter") StudentClazz studentClazzFilter,
            @Param("orderBy") String orderBy);

    /**
     * 根据关联主表Id列表，获取关联从表数据列表。
     *
     * @param clazzIds 关联主表Id列表。
     * @param studentFilter 从表过滤对象。
     * @param orderBy 排序字符串，order by从句的参数。
     * @return 从表数据列表。
     */
    List<Student> getStudentListByClazzIds(
            @Param("clazzIds") List<Long> clazzIds,
            @Param("studentFilter") Student studentFilter,
            @Param("orderBy") String orderBy);

    /**
     * 根据关联主表Id，获取关联从表中没有和主表建立关联关系的数据列表。
     *
     * @param clazzId 关联主表Id。
     * @param studentFilter 过滤对象。
     * @param orderBy 排序字符串，order by从句的参数。
     * @return 与主表没有建立关联的从表数据列表。
     */
    List<Student> getNotInStudentListByClazzId(
            @Param("clazzId") Long clazzId,
            @Param("studentFilter") Student studentFilter,
            @Param("orderBy") String orderBy);

    /**
     * 根据关联主表Id，获取关联从表数据列表。
     *
     * @param guardianId 关联主表Id。
     * @param studentFilter 从表过滤对象。
     * @param studentGuardianFilter 多对多关联表过滤对象。
     * @param orderBy 排序字符串，order by从句的参数。
     * @return 从表数据列表。
     */
    List<Student> getStudentListByGuardianId(
            @Param("guardianId") Long guardianId,
            @Param("studentFilter") Student studentFilter,
            @Param("studentGuardianFilter") StudentGuardian studentGuardianFilter,
            @Param("orderBy") String orderBy);

    /**
     * 根据关联主表Id列表，获取关联从表数据列表。
     *
     * @param guardianIds 关联主表Id列表。
     * @param studentFilter 从表过滤对象。
     * @param orderBy 排序字符串，order by从句的参数。
     * @return 从表数据列表。
     */
    List<Student> getStudentListByGuardianIds(
            @Param("guardianIds") List<Long> guardianIds,
            @Param("studentFilter") Student studentFilter,
            @Param("orderBy") String orderBy);

    /**
     * 根据关联主表Id，获取关联从表中没有和主表建立关联关系的数据列表。
     *
     * @param guardianId 关联主表Id。
     * @param studentFilter 过滤对象。
     * @param orderBy 排序字符串，order by从句的参数。
     * @return 与主表没有建立关联的从表数据列表。
     */
    List<Student> getNotInStudentListByGuardianId(
            @Param("guardianId") Long guardianId,
            @Param("studentFilter") Student studentFilter,
            @Param("orderBy") String orderBy);
}
